home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / CD-ROM Tools / DCPlayer 17 / ReadMe < prev    next >
Text File  |  1996-09-26  |  9KB  |  226 lines
  1. DCPlayer - another pulsating Blender Software (BS) production
  2. -------------------------------------------------------------
  3.  
  4. It's yet another music CD player. This one takes very little memory, only 3%
  5. CPU time, works in the background, and watches the joypad or joystick plugged
  6. into controller port 1 on the CD32 or the game port on normal Amigas.
  7.  
  8. So now you can play CDs whilst doing something else using Workbench. When you
  9. want to swap CDs, skip tracks, or something like that press a button on the
  10. joypad and carry on with what you were doing before instead of messing about
  11. shuffling through windows or screens, clicking on something, then finding
  12. your way back.
  13.  
  14. I wrote it to help me to sample CDs though. Connect a sampler from the CD32's
  15. audio output to the SX-1's parallel port, load up this, load up some sample
  16. software, and use this to skip to the right place BEFORE starting to sample.
  17. Easy, eh?
  18.  
  19. At the moment nobody's found out a way of ripping music straight from CD to
  20. memory with cd.device, so this is the easiest way (just try it with the mouse
  21. on the other CD players to see what I mean).
  22.  
  23.  
  24. So, what does it work on?
  25. -------------------------
  26.  
  27. Er, the CD32. You'll need to be able to use the Workbench or a shell. You can
  28. do that with a keyboard, a serial link which connects to the Aux port, or the
  29. SX-1 or CD32x which connect to the expansion port.
  30.  
  31. It should also work on Kickstart 2 or above Amigas with CD drives, provided
  32. that you're running some kind of CD32 emulation software and you've got
  33. lowlevel.library in the LIBS: directory. Some examples...
  34.  
  35.     - An A600 or A1200 with the Archos Overdrive CD drive.
  36.     - An A600 or A1200 with the Hisoft Squirrel or Power CD drive
  37.       (both these drives are really the same).
  38.     - Any Amiga with Cache-CDFS and an IDE or SCSI CD drive.
  39.     - Any Amiga with Kickstart 3.1 and a SCSI-2 CD drive.
  40.  
  41. It doesn't work with the CDTV or A570 because those machines use cdtv.device
  42. and I don't have any info on that. So there.
  43.  
  44.  
  45. Installing
  46. ----------
  47.  
  48. Drag the icon to your C: drawer or some other drawer that you've got set
  49. aside for programs. That's it. Have some Battenburg cake.
  50.  
  51.  
  52. Options
  53. -------
  54.  
  55. All of the options can be used in the tooltype list (click on DCPlayer and
  56. choose Information from the Icons menu to get this) if you run it from
  57. Workbench or placed after the program name if you run it from the shell.
  58.  
  59. Read out options...
  60.  
  61. - SHOW=<type>
  62.   You get a little read out on the screen of what's happening. It's really a
  63.   sprite, so it doesn't matter if you flip screens or have an autoscrolling
  64.   Workbench screen, it always stays there.
  65.  
  66.   The types are TRACK, STARTCD, STARTTRACK, ENDTRACK, ENDCD, and CHANGE. Each
  67.   type gives you a different read out (the names are obvious enough) but you
  68.   can change it whilst DCPlayer is running with the SHUFFLE button (if you've
  69.   got a CD32 joypad).
  70.  
  71. - COLOUR1=<R><G><B>
  72.   COLOUR2=<R><G><B>
  73.   COLOUR3=<R><G><B>
  74.   The highlight, shadowed, and bright colours of the read out. Each R, G, and
  75.   B number ranges from 0 to 9 or A to F (for 10 to 15). You can't leave a
  76.   space between the numbers. If you want, you can use COLOR.
  77.  
  78. - LEFT=<number>
  79.   The distance from the left edge of the screen to the read out. 0 is the far
  80.   left and 319 is the far right (but it could be a bit more if you've got an
  81.   overscanned screen).
  82.  
  83. - TOP=<number>
  84.   The distance from the top edge of the screen to the read out. 0 is the top
  85.   and 255 (or 199 for NTSC) is the bottom edge (or a bit more for overscan).
  86.  
  87. CD options...
  88.  
  89. - EMULATION=<type>
  90.   Make buggy CD32 emulation work. See the emulation doc file for more info.
  91.  
  92. - LOOP=<type>
  93.   Start up DCPlayer in repeat play mode. The options are REPEAT and REPEAT1,
  94.   but you can change it with the LOOP button (if you've got a CD32 joypad).
  95.  
  96. - PLAY=<track>
  97.   Start DCPlayer playing a CD, if there's a CD in the drive and the track
  98.   exists. Or you can give RANDOM if you want, which starts the thing off in
  99.   random play mode.
  100.  
  101. Switches...
  102.  
  103. - CHANGE
  104.   Short for SHOW=CHANGE. Kept for compatibility with older versions. Aren't
  105.   I kind?
  106.  
  107. - DISPLAY
  108.   Short for SHOW=TRACK. Kept for com... Zzzz...
  109.  
  110. - NOBACKDROPS
  111.   If it's using pen sharing and it couldn't get the pens it needed then it
  112.   removes Workbench's backdrops from the screen, tries again, replaces the
  113.   backdrops, and lets them fight over the remaining pens, unless you use
  114.   this option.
  115.  
  116. - NOLORES
  117.   On AGA computers, it makes sprites on the Workbench screen lo-res in all
  118.   screen modes (to stop the read out looking thin in eg. super hi-res),
  119.   unless you give this option. For non-AGA computers, this option's on all
  120.   the time whether you choose it or not.
  121.  
  122. - NOPENS
  123.   On Kickstart 3 computers with more than 16 colours on the Workbench screen,
  124.   it tries to stop the screen setting the read out's pen colours by using pen
  125.   sharing, unless you give this option. For non-Kickstart 3 computers, this
  126.   option's on all the time whether you choose it or not.
  127.  
  128. - NORESET
  129.   Turn off the reset on eject option, for anyone who booted from CD and
  130.   doesn't want the CD32 to reset as soon as the boot CD is removed. If you
  131.   want to put this program on a PD CD then it's probably a good idea to
  132.   delete the brackets either side of this option in the tooltypes list.
  133.  
  134. The defaults are no read outs, some very tasteful colours, the left edge just
  135. a little bit away from the right of the screen, the top edge just a little
  136. bit away from the bottom of the screen, no changes for buggy CD32 emulation,
  137. no repeat play, don't play any tracks, backdrops on, lo-res on, pen sharing
  138. on, and leave the reset on eject alone.
  139.  
  140. Screen modes that need a lot of the computer's time to display (eg. DblPAL,
  141. DblNTSC, Super72, and probably more) can't use many sprites. 'Cos of this,
  142. sometimes the read out might not even appear, but you can try using less
  143. colours or shrinking the overscan size so less time is taken up.
  144.  
  145. If you've got lo-res sprites or pen sharing, you can't change the Workbench
  146. screen (eg. you can't use things such as overscan, palette, or screen mode
  147. prefs). You have to quit DCPlayer and then click on Retry. If you don't like
  148. this, use NOLORES and NOPENS.
  149.  
  150.  
  151. Running
  152. -------
  153.  
  154. From the Workbench, click on the icon once to start it and again to stop it.
  155.  
  156. From the shell, type "DCPlayer" to start it and hit CTRL-C to stop it. Or
  157. you can use "Run <>NIL: DCPlayer" to start it and the same again to stop it.
  158. The "Break" command works too.
  159.  
  160. To run it all the time, drag it to your WBStartup drawer or put "Run <>NIL:
  161. DCPlayer" at the end of your User-Startup.
  162.  
  163.  
  164. Controls
  165. --------
  166.  
  167. The CD32 joypad is used in almost the same way as it is in the CD32's music
  168. CD player, but there are a few differences. The stop button really stops the
  169. CD if you press it twice. Skipping through tracks is slightly different. The
  170. play button opens or closes the drive door.
  171.  
  172. If the CD is stopped, pressing reverse/forward/stop will quit and pressing
  173. the shuffle button will start the CD playing in random play mode.
  174.  
  175. If the CD isn't stopped, the shuffle button will shuffle through the kind of
  176. read out you get - this is useful for finding the exact part of a CD you want
  177. to sample. Just for those people who've had a lobotomy the types are - the
  178. track number, the time since the start of the CD, the time since the start of
  179. the track, the time to the end of the track, the time to the end of the CD,
  180. and only display changes for a short time (say when a new track has started
  181. to play, the track number will appear for a little while then disappear).
  182.  
  183. If you don't have a CD32 joypad you can also use a Megadrive joypad, a Master
  184. System joypad, or a two button joystick instead. With these you can't eject
  185. CDs, use random play, change the read out, repeat tracks, or quit using the
  186. controller. A shocking loss as I'm sure you'll agree.
  187.  
  188. Finally if you've got an old crappy single fire button joystick you miss out
  189. on all that lot and you can't stop the CD either (but you can still pause it
  190. though).
  191.  
  192.     Function        CD32 joypad        Others
  193.     --------        -----------        ------
  194.  
  195.     Play/Pause        Select            Fire
  196.     Stop/Really stop    Stop            (2nd fire)
  197.     Eject/Close        Play            (3rd fire)
  198.     Search <        Reverse            Up
  199.     Search >        Forward            Down
  200.     Track <            Left            Left
  201.     Track >            Right            Right
  202.     Random play/Read out    Shuffle
  203.     None/Repeat/Repeat 1    Loop
  204.     Quit            Reverse/Forward/Stop
  205.  
  206.  
  207. Boring wibble
  208. -------------
  209.  
  210. This is copyrighted by me but freely distributible. It shouldn't be altered
  211. in any way and you should only charge for disks, postage, or packing if you
  212. charge anything.
  213.  
  214. If something goes wrong (it crashes, an android appears from a trapdoor in
  215. the floor and blows up your CD32, etc...) then I can't be held responsible
  216. for the mess - you use this program at your own risk. After all, it's free -
  217. what more do you want?
  218.  
  219. And it can't be used as part of anything that's sold for profit without my
  220. say so, although the chances of that are fairly remote, I think. Oh, that
  221. means cover CDs and disks on those glossy magazines as well.
  222.  
  223. My Email address is dan@blender.demon.co.uk, if you spot a bug or something.
  224.  
  225. Dan.
  226.